home *** CD-ROM | disk | FTP | other *** search
/ AGA Toolkit '97 / The AGA Toolkit '97.iso / miscellaneous / help / dos / gui-guru / guru.doc < prev    next >
Encoding:
Text File  |  1996-09-07  |  6.0 KB  |  163 lines
  1.                           GUI-Guru Version 0.9b
  2.  
  3.                  a Graphical User Interface Guru analyser
  4.  
  5.                      by DM Hollway 29th November 1993
  6.  
  7.  
  8. Standard American Legal Disclaimer-type thing:
  9.  
  10.  This piece of software is supplied "as-is"; the author cannot be held
  11.  liable for any loss or damage occurred as a result of the use of this
  12.  software.  Even if your cat spontaneously combusts,  or a piano falls 
  13.  on you,  as a direct result of your  using this program, it's *NOT MY
  14.  FAULT*.
  15.  
  16.  
  17. System Requirements
  18.  
  19.     Any Amiga with 512K RAM or more, and Kickstart 1.3 or higher
  20.     (GUI-Guru is enhanced under Kickstart 2.0 and above)
  21.     
  22.     GUI-Guru has been tested on the following Amiga configurations:
  23.  
  24.     A4000, EC030 @ 25MHz, 2MB Chip, 4MB Fast, Kickstart 3.0  (v39.106)
  25.  
  26.     A4000, EC030 @ 25MHz, 2MB Chip, 4MB Fast, Kickstart 2.04 (v37.175)
  27.  
  28.     A4000, EC030 @ 25MHz, 2MB Chip, 4MB Fast, Kickstart 1.3  (v34.005)
  29.  
  30.     A500,  68000 @  7MHz, 1MB Chip, 2MB Fast, Kickstart 1.3  (v34.005)
  31.  
  32.     A1200, 68020 @ 14MHz, 2MB Chip, 0MB Fast, Kickstart 3.0  (v39.106)
  33.  
  34.  
  35.     I'd therefore hazard a guess that GUI-Guru will work on any Amiga
  36.     system meeting the above requirements (go on, prove me wrong..;)
  37.     
  38. **NOTE: Although GUI-Guru *will* work under 1.3, the window might appear a
  39.   little odd, due to the white & black colours being reversed under 1.3.
  40.   There's nothing I can do about this; GUI-guru will still work fine!
  41.  
  42.  
  43. Running GUI-Guru
  44.  
  45.     GUI-Guru can be run from either the workbench (by clicking on its
  46. icon) or from the CLI/Shell.
  47.  
  48.     GUI-Guru supports the following command-line options:
  49.  
  50.     GUIGuru        -   starts the program and displays the main window.
  51.  
  52.     GUIGuru ?      -   displays usage information about the program.
  53.  
  54.     GUIGuru [X]    -   starts the program and displays the window, and
  55.                        displays in the window the meaning of Guru number
  56.                        [X].
  57.  
  58.    Plus a secret command line option - I leave it to you to discover it!
  59.  
  60. What is GUI-Guru?
  61.  
  62.     Almost every Amiga owner has seen a "Guru" (or "Software Failure" as it's
  63. known under Kickstart 2.0 and above). That flashing red box causes a shudder
  64. of fear to pass through even the most hardened amiga expert. But the Guru 
  65. has a purpose; the two numbers displayed in the flashing red box can tell
  66. you the reason why the Amiga crashed. The numbers take the following form:
  67.  
  68.                         12 34 5678 . ABCDEFGH
  69.  
  70. The right-hand eight digits give the location in your Amiga's memory at which
  71. the problem occurred. The leftmost eight digits, however, give the most
  72. useful information. They can tell you which area (or SUBSYTEM) of the Amiga's
  73. operating system crashed, and they can also give specific information on the
  74. cause of the problem.
  75.   But what do these mystical numbers mean? GUI-Guru is a program to display
  76. the meaning of Guru numbers in an attractive graphical form. On running
  77. GUI-Guru, a small window will open on your workbench screen. The window looks
  78. something like this:
  79.  
  80.       (1)--->[]Gui-Guru v0.9b=======================|]
  81.              |           _________                   |
  82.              | Number:  |_(2)_____| (8 digit number) |
  83.              |            __________________________ |
  84.              |Subsystem: | (3)                     | |
  85.              |           |                         | |
  86.              |General:   | (4)                     | |
  87.              |           |                         | |
  88.              |Specific:  |_(5)_____________________| |
  89.              |  _______                    ________  |
  90.     (6)----->| | About |                  |  Quit  |<-----(7)
  91.              +--=======--------------------========--+
  92.  
  93.  
  94. What does it all mean?
  95.  
  96.       The areas of the window have the following purpose:
  97.  
  98.  (1) This is the CLOSE gadget. Click here with the mouse to exit the
  99.      program.
  100.  
  101.  (2) This is a STRING gadget; to enter a number, click in this gadget and
  102.      type in the guru number.
  103.  
  104.  (3) On typing in a number, this area of the window will show the subsystem
  105.      of the amiga that reported the crash, for example "workbench".
  106.  
  107.  (4) This area of the window displays general details of the fault, if
  108.      available.
  109.  
  110.  (5) Specific details of *why* the subsystem indicated in (3) crashed are
  111.      displayed here.
  112.  
  113.  (6) Click here to display some information about the program and the
  114.      author.
  115.  
  116.  (7) Click here to exit the program (as for (1), above).
  117.  
  118.  
  119. Distribution
  120.  
  121.     This program is FREEWARE. You may freely copy and distribute this
  122. program, but you may not charge more than a reasonable amount for the media 
  123. on which the program is stored ("reasonable" denotes the amount typically
  124. charged by PD libraries).
  125.     This program may be included in software collections (eg Fred Fish's
  126. excellent disk library, CDPD, Aminet, TBAG etc) provided that the author is notified
  127. by E-mail (see below) prior to the inclusion.
  128.  
  129. Contacting the Author
  130.  
  131.     Should you feel an overwhelming urge to show your appreciation of
  132. this program, the author can be contacted at:
  133.  
  134.   E-Mail (Internet): dmh-a@minster.york.ac.uk
  135.                 or   dmh11@tower.york.ac.uk
  136.  
  137.   but only until June 1994; after that date the author will be whooping it
  138. up at a secret location in Switzerland..
  139.  
  140.   Or if you want to send me gifts (4MB x 32-bit SIMMS are always welcome, as
  141. are SCSI controllers, multisync monitors etc :)
  142.  
  143.  SnailMail:          DM Hollway
  144.                      Langwith College
  145.                      University of York
  146.                      Heslington
  147.                      York
  148.                      YO1 5DD
  149.  
  150.  
  151. Remember: Only   //Amiga makes it possible!
  152.                \X/ "Life begins at '030 and gets fun at '040.
  153.                     Senility strikes at '86"
  154.  
  155. Picture this: Commodore release a new Amiga. It's HP/PA RISC-based,
  156. supports 2 gigabyte of CHIP memory, 8 gigabyte of FAST memory, has
  157. display resolutions of up to 4096x1280x16.7Million colours, comes with
  158. a 1 terabyte hard drive, two HD floppies and a CD drive as standard,
  159. and retails for £299.99.
  160.     What's the first question the computer world asks about the new machine?
  161.  
  162.     "Is it PC compatible?"
  163.